今天開始終於我們實作的部分,我應該會照著 Python 官方文件的流程去執行各個步驟來上傳我們的套件到 PyPI
,不過在那之前,我們需要先在我們的 Github 上面建立專案,才能上傳到 PyPI
上。
第一步會需要登入 Github,如果已經有帳號的人就直接登入很簡單,如果還沒申請帳號的,可以先從 Github 官網 進去後點選右上角的 Sign up 進入申請畫面。
進去後會先要你填信箱,密碼與暱稱。
填完會問你要不要收到他們的最新訊息,可以不用勾選沒關係,自己斟酌。
接下來回答認證問題跟從信箱獲得認證碼輸入後,就完成帳號申請了。再來就能直接輸入帳號密碼登入,Github 也有提供雙重認證,想讓自己的帳號更安全的也可以去申請,這邊就不多做介紹了。
新登入的帳號會長得像下圖,分成三個區塊:
簡單介紹 Repository,就是我們存放原始碼在 Github 的地方,之後可以使用 Github 提供的連結以及 git
的指令來操作,就能在本地端編輯原始碼並上傳回 Github 上,這陸續也會介紹。
接著我們是不宜遲就點選 Create Repository 來創建我們第一個 Repo(Repository 簡寫之後都會用這個來代替) 吧。
進入創建頁面,首先要填的就是 Repo 的名稱,這個在之後修改會比較麻煩,所以建議先想好再填,不過如果真的不小心填錯之後也是能改的,不用太擔心。這次因為是棒球的 Python 套件,所以我把套件命名為 baseball-stats-python
,幾個原因,一個是不想跟 pybaseball
太像,另一個是我自己比較喜歡 kebab-case
(用 -
分隔名詞) 的命名方式,相較於 snake_case
(用 _
分隔名詞) 或是全部黏在一起,這個就比較像是個人喜好,不太會影響功能。
輸入完名稱系統會幫你確認能不能使用,可以的話就會有一個綠色的小勾在旁邊,代表可以使用。下面一欄是這個 Repo 的介紹,這個可以先不用輸入,之後修改也滿簡單的。
再來依序要選擇:
.gitignore
,在把程式碼上傳到 Github 的時候,可以不用把所有檔案都上傳,這時候就可以使用這個檔案裡告訴 git
哪些檔案不用上傳。不過我們暫時還不確定哪些不用上傳,所以這邊可以先不勾選,之後再自己加就好了這些都選完後就能點選創建,完成後就能看到我們的專屬 Repo 頁了,可以看到我們剛才如果有請 Github 幫我們創建 README 的話就會出現在下方,目前還沒有任何內容,不過我們也完成第一步了。
今天終於建出 Repo 了,不知道這樣的進度還行不行,我自己原本是預計前面這邊很快就能結束,但自己在寫的時候又發現好像可以講細一點,就越寫篇幅越多了,希望介紹的還可以。
明天會介紹各個 License,如果篇幅夠的話會介紹一些 git
指令,感謝大家耐心看完這篇文章,一樣如果有任何問題與建議歡迎在留言告訴我,明天見 掰掰。